package com.dms.modules.product.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.dms.modules.product.dto.ProductDTO;
import com.dms.modules.product.dto.ProductQueryDTO;
import com.dms.modules.product.dto.ProductSearchDTO;
import com.dms.modules.product.entity.Product;
import com.dms.modules.product.vo.ProductDetailVO;
import com.dms.modules.product.vo.ProductFavoriteVO;
import com.dms.modules.product.vo.ProductReviewVO;

import java.util.List;

/**
 * 商品服务接口
 */
public interface ProductService extends IService<Product> {
    
    /**
     * 获取商品详情
     * @param id 商品ID
     * @return 商品详情
     */
    ProductDetailVO getProductDetail(Long id);
    
    /**
     * 创建商品
     * @param productDTO 商品信息
     * @return 是否成功
     */
    boolean create(ProductDTO productDTO);
    
    /**
     * 更新商品
     * @param productDTO 商品信息
     * @return 是否成功
     */
    boolean update(ProductDTO productDTO);
    
    /**
     * 删除商品
     * @param id 商品ID
     * @return 是否成功
     */
    boolean delete(Long id);
    
    /**
     * 获取商品详情
     * @param id 商品ID
     * @return 商品详情
     */
    ProductDTO getDetail(Long id);
    
    /**
     * 分页查询商品列表
     * @param page 分页参数
     * @param categoryId 分类ID
     * @param keyword 关键词
     * @param status 状态
     * @return 商品列表
     */
    Page<Product> list(Page<Product> page, Long categoryId, String keyword, Integer status);
    
    /**
     * 更新商品状态
     * @param id 商品ID
     * @param status 状态
     * @return 是否成功
     */
    boolean updateStatus(Long id, Integer status);
    
    /**
     * 更新商品库存
     * @param id 商品ID
     * @param quantity 数量变化（正数增加，负数减少）
     * @return 是否成功
     */
    boolean updateStock(Long id, Integer quantity);
    
    /**
     * 统一搜索接口
     * @param searchDTO 搜索条件
     * @return 商品分页列表
     */
    IPage<Product> search(ProductSearchDTO searchDTO);
    
    /**
     * 获取商品列表
     * @param queryDTO 查询条件
     * @return 商品列表
     */
    IPage<Product> getProductList(ProductQueryDTO queryDTO);
    
    /**
     * 获取推荐商品列表
     * @return 推荐商品列表
     */
    List<ProductDetailVO> getRecommendProducts();
    
    /**
     * 获取热销商品列表
     * @param limit 获取数量
     * @return 热销商品列表
     */
    List<ProductDetailVO> getHotProducts(Integer limit);
    
    /**
     * 获取新品列表
     * @param limit 获取数量
     * @return 新品列表
     */
    List<ProductDetailVO> getNewProducts(Integer limit);
    
    /**
     * 分页查询商品
     * @param queryDTO 查询条件
     * @return 商品列表
     */
    IPage<Product> pageProducts(ProductQueryDTO queryDTO);
    
    /**
     * 增加商品销量
     * @param id 商品ID
     * @param quantity 增加数量
     * @return 是否成功
     */
    boolean increaseSales(Long id, Integer quantity);
    
    /**
     * 增加商品浏览量
     * @param id 商品ID
     * @return 是否成功
     */
    boolean increaseViewCount(Long id);

    /**
     * 根据分类ID获取商品列表
     * @param categoryId 分类ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 商品列表
     */
    IPage<Product> getProductsByCategory(Long categoryId, Integer pageNum, Integer pageSize);

    /**
     * 获取商家商品
     *
     * @param merchantId 商家ID
     * @param pageNum   页码
     * @param pageSize  每页条数
     * @return 商品分页列表
     */
    IPage<Product> getProductsByMerchant(Long merchantId, Integer pageNum, Integer pageSize);

    /**
     * 获取搜索建议
     * @param keyword 关键词
     * @param limit 返回数量限制
     * @return 搜索建议列表
     */
    List<String> getSearchSuggestions(String keyword, Integer limit);

    /**
     * 获取用户搜索历史
     * @param userId 用户ID
     * @param limit 返回数量限制
     * @return 搜索历史列表
     */
    List<String> getSearchHistory(Long userId, Integer limit);

    /**
     * 保存搜索历史
     * @param userId 用户ID
     * @param keyword 搜索关键词
     */
    void saveSearchHistory(Long userId, String keyword);

    /**
     * 清除搜索历史
     * @param userId 用户ID
     */
    void clearSearchHistory(Long userId);

    /**
     * 更新商品销量
     * @param id 商品ID
     * @param quantity 数量
     * @return 是否成功
     */
    boolean updateSales(Long id, Integer quantity);

    /**
     * 添加商品
     * @param product 商品信息
     * @return 是否成功
     */
    boolean addProduct(Product product);

    /**
     * 更新商品
     * @param product 商品信息
     * @return 是否成功
     */
    boolean updateProduct(Product product);

    /**
     * 删除商品
     * @param id 商品ID
     * @return 是否成功
     */
    boolean deleteProduct(Long id);

    /**
     * 统计商家的商品数量
     * @param merchantId 商家ID
     * @return 商品数量
     */
    int countMerchantProducts(Long merchantId);

    /**
     * 搜索商品
     * @param searchDTO 搜索条件
     * @return 商品分页列表
     */
    IPage<Product> searchProducts(ProductSearchDTO searchDTO);
    
    /**
     * 获取相关商品推荐
     * @param productId 商品ID
     * @param limit 限制数量
     * @return 商品列表
     */
    List<Product> getRelatedProducts(Long productId, Integer limit);
    
    /**
     * 获取热门商品
     * @param categoryId 分类ID，可为空
     * @param limit 限制数量
     * @return 商品列表
     */
    List<Product> getHotProducts(Long categoryId, Integer limit);
    
    /**
     * 获取新品上架
     * @param categoryId 分类ID，可为空
     * @param limit 限制数量
     * @return 商品列表
     */
    List<Product> getNewProducts(Long categoryId, Integer limit);
    
    /**
     * 增加商品浏览量
     * @param productId 商品ID
     */
    void incrementViewCount(Long productId);

    /**
     * 搜索商品
     * @param keyword 关键词
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 商品分页列表
     */
    IPage<Product> searchProducts(String keyword, Integer pageNum, Integer pageSize);

    /**
     * 获取店铺商品列表
     * @param shopId 店铺ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 商品分页列表
     */
    IPage<Product> getShopProducts(Long shopId, Integer pageNum, Integer pageSize);

    /**
     * 商家搜索自己的商品（包含状态筛选）
     * @param searchDTO 搜索条件
     * @param status 商品状态：0-下架，1-上架
     * @return 商品分页列表
     */
    IPage<Product> searchMerchantProducts(ProductSearchDTO searchDTO, Integer status);

    /**
     * 管理员搜索商品（包含审核状态筛选）
     * @param searchDTO 搜索条件
     * @param auditStatus 审核状态：0-待审核，1-通过，2-拒绝
     * @return 商品分页列表
     */
    IPage<Product> adminSearchProducts(ProductSearchDTO searchDTO, Integer auditStatus);

    /**
     * 获取待审核商品列表
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 待审核商品分页列表
     */
    IPage<Product> getAuditPendingProducts(Integer pageNum, Integer pageSize);

    // 评价相关
    boolean addReview(Long userId, Long productId, String content, Integer rating);
    boolean deleteReview(Long userId, Long reviewId);
    boolean likeReview(Long userId, Long reviewId);
    boolean unlikeReview(Long userId, Long reviewId);
    boolean replyReview(Long reviewId, String reply);
    IPage<ProductReviewVO> getProductReviews(Long productId, Integer pageNum, Integer pageSize);
    IPage<ProductReviewVO> getUserReviews(Long userId, Integer pageNum, Integer pageSize);
    Integer getReviewCount(Long productId);
    Double getAverageRating(Long productId);
    
    // 收藏相关
    boolean addFavorite(Long userId, Long productId);
    boolean cancelFavorite(Long userId, Long productId);
    boolean isFavorite(Long userId, Long productId);
    Integer getFavoriteCount(Long productId);
    IPage<ProductFavoriteVO> getUserFavorites(Long userId, Integer pageNum, Integer pageSize);
    
    // 推荐相关
    List<ProductDetailVO> getPersonalizedRecommendations(Long userId, Integer limit);
    List<ProductDetailVO> getBrowseHistoryRecommendations(Long userId, Integer limit);
    List<ProductDetailVO> getFavoriteRecommendations(Long userId, Integer limit);
    List<ProductDetailVO> getSearchHistoryRecommendations(Long userId, Integer limit);
    List<ProductDetailVO> getColdStartRecommendations(Long userId, Integer limit);
    List<ProductDetailVO> getDiversityRecommendations(Long userId, Integer limit);
} 